Manual: `F0af`_`[Blackhole Management ↗`a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu`g=reticulum|r=reticulum|ref=HEAD|path=docs/markdown/using.md|anchor=using-blackhole-management]`_`f
The `!blackhole`! system allows operators and users to block unwanted `F0af`_`[identities`:/page/wiki.mu`path=Identity]`_`f at the `F0af`_`[transport`:/page/wiki.mu`path=Transport_node]`_`f layer.
Any `F0af`_`[announces`:/page/wiki.mu`path=Announce]`_`f from blocked identities will be silently dropped, preventing them from being propagated through your `F0af`_`[node`:/page/wiki.mu`path=Node]`_`f and for other nodes to reach their `F0af`_`[destinations`:/page/wiki.mu`path=Destination]`_`f through you (or your network segment).`:cite-ref-1[`F5bf`_`[1`#cite-note-1]`_`f]
`*`!Note:`! There is no way to globally block or censor an identity in Reticulum networks, as long as someone is willing to provide transport for it.`*
>>Contents
• `F0af`_`[Usage`#usage]`_`f
• `F0af`_`[Federation`#federation]`_`f
• `F0af`_`[Publishing`#publishing]`_`f
• `F0af`_`[Subscribing`#subscribing]`_`f
• `F0af`_`[See also`#see-also]`_`f
• `F0af`_`[References`#references]`_`f
>>Usage
The `F0af`_`[rnpath`:/page/wiki.mu`path=Rnpath]`_`f utility can be used to manage the blackhole list of an `F0af`_`[instance`:/page/wiki.mu`path=Instance]`_`f. To specify which instance to mange the blackhole list for, use the `B100`F9d9--config=`*<config dir>`*`f`b option.
To add an identity to the blackhole list:
`B100`F9d9rnpath --blackhole `*<identity>`* --duration `*<hours>`* --reason "`*<reason>`*"`f`b
`B100`F9d9--duration`f`b and `B100`F9d9--reason`f`b are optional, defaulting to forever for no particular reason.
For example:
`B100`F9d9rnpath --blackhole 3a4f8b9c1d2e3f4g5h6i7j8k9l0m1n2o --duration 24 --reason "Excessive announces"`f`b
To remove an identity from the blackhole list:
`B100`F9d9rnpath --unblackhole `*<identity>`*`f`b
To see all identities in the blackhole list:
`B100`F9d9rnpath --blackholed`f`b
>>Federation
To maintain an up-to-date list across many nodes on a large network, you can subscribe to blackhole lists maintained and published by trusted peers or a central authority that you manage yourself.`:cite-ref-2[`F5bf`_`[2`#cite-note-2]`_`f]
`*`!Note:`! This relies on the trust relationship between the subscriber and the publisher. By subscribing to a source, you are implicitly trusting that source to only block relevant identities.`*
There are plans to integrate the blackhole system with `F0af`_`[network identities`:/page/wiki.mu`path=Network_identity]`_`f in the future, adding a layer of cryptographic trust to the federation process.
>>>Publishing
To publish a node's blackhole list, set `B100`F9d9publish_blackhole = true`f`b in the `B100`F9d9[reticulum]`f`b section of the `F0af`_`[RNS`:/page/wiki.mu`path=RNS]`_`f instance's `F0af`_`[configuration file`:/page/wiki.mu`path=RNS|anchor=configuration]`_`f.
>>>Subscribing
To subscribe to blackhole lists, add `B100`F9d9blackhole_sources = `*<identity, identity, …>`*`f`b with a comma separated list of identities to the `B100`F9d9[reticulum]`f`b section of the RNS instance's configuration file.
To see which lists you are subscribed to and their contents:
`B100`F9d9rnpath --blackholed-list`f`b
>>See also
• `F0af`_`[rnpath`:/page/wiki.mu`path=Rnpath]`_`f
>>References
`:cite-note-1`!1.`! `F0af`_`[↑`#cite-ref-1]`_`f `*Blackhole Management`*, Manual. `F0af`_`[`a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu`g=reticulum|r=reticulum|ref=HEAD|path=docs/markdown/using.md|anchor=blackhole-management] ↗`_`f
`:cite-note-2`!2.`! `F0af`_`[↑`#cite-ref-2]`_`f `*Automated List Sourcing`*, Manual. `F0af`_`[`a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu`g=reticulum|r=reticulum|ref=HEAD|path=docs/markdown/using.md|anchor=automated-list-sourcing] ↗`_`f
>>Reticulum concepts
`F0af`_`[Announce`:/page/wiki.mu`path=Announce]`_`f • Blackhole • `F0af`_`[Buffer`:/page/wiki.mu`path=Buffer]`_`f • `F0af`_`[Channel`:/page/wiki.mu`path=Channel]`_`f • `F0af`_`[Destination`:/page/wiki.mu`path=Destination]`_`f • `F0af`_`[Discovery`:/page/wiki.mu`path=Discovery]`_`f • `F0af`_`[Identity`:/page/wiki.mu`path=Identity]`_`f • `F0af`_`[Instance`:/page/wiki.mu`path=Instance]`_`f • `F0af`_`[Interface`:/page/wiki.mu`path=Interface]`_`f • `F0af`_`[Interface Access Code`:/page/wiki.mu`path=Interface_Access_Code]`_`f (IFAC) • `F0af`_`[Link`:/page/wiki.mu`path=Link]`_`f • `F0af`_`[Network identity`:/page/wiki.mu`path=Network_identity]`_`f • `F0af`_`[Node`:/page/wiki.mu`path=Node]`_`f • `F0af`_`[Packet`:/page/wiki.mu`path=Packet]`_`f • `F0af`_`[Path`:/page/wiki.mu`path=Path]`_`f • `F0af`_`[Propagation node`:/page/wiki.mu`path=Propagation_node]`_`f • `F0af`_`[Resource`:/page/wiki.mu`path=Resource]`_`f • `F0af`_`[Stamp`:/page/wiki.mu`path=Stamp]`_`f • `F0af`_`[Transport node`:/page/wiki.mu`path=Transport_node]`_`f